home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Libraries / CW GUSI 1.6.4 / doc / pod / GUSI_PPC.pod < prev    next >
Text File  |  1995-03-11  |  2KB  |  56 lines
  1. =head1 PPC sockets
  2.  
  3. These provide authenticated stream sockets without out-of-band
  4. data. PPC sockets should work between all networked Macintoshes running System 7,
  5. and between applications on a single Macintosh running System 7.
  6.  
  7. =head2 Differences to generic behavior
  8.  
  9.  
  10. PPC socket addresses have the following format:
  11.  
  12.     struct sockaddr_ppc {
  13.       short             family;     /* Always AF_PPC                     */
  14.       LocationNameRec   location;   /* Check your trusty Inside Macintosh  */
  15.       PPCPortRec        port;
  16.     };
  17.  
  18. C<choose()> currently only works for existing sockets. To restrict the choice of
  19. addresses presented, pass a pointer to the following structure for the C<constraint>
  20. argument:
  21.  
  22.     typedef struct   {
  23.       short       flags;
  24.       Str32       nbpType;
  25.       PPCPortRec  match;
  26.     } sa_constr_ppc;
  27.  
  28. C<flags> is obtained by or'ing one or several of the following constants:
  29.  
  30. =over 4
  31.  
  32. =item C<PPC_CON_NEWSTYLE>
  33.  
  34. Always required for compatibility reasons.
  35.  
  36. =item C<PPC_CON_MATCH_NBP>
  37.  
  38. Only display machines that have registered an entity of type C<nbpType>.
  39.  
  40. =item C<PPC_CON_MATCH_NAME>
  41.  
  42. Only display ports whose name matches C<match.name>.
  43.  
  44. =item C<PPC_CON_MATCH_TYPE>
  45.  
  46. Only display ports whose type matches C<match.u.portType>.
  47.  
  48. =back
  49.  
  50. C<nbpType> specifies the machines to be displayed, as explained above. C<match> contains the name
  51. and/or type to match against.
  52.  
  53. C<connect()> will block even if the socket is nonblocking. In practice, however,
  54. delays are likely to be quite short, as it never has to block on a higher level
  55. protocol and the PPC ToolBox will automatically establish the connection.
  56.